home *** CD-ROM | disk | FTP | other *** search
/ PC-SIG: World of Games / PC-SIG World of Games (CDRM1080710) (1993).iso / 1293 / INSTRUCT.DOC < prev    next >
Text File  |  1992-10-05  |  35KB  |  704 lines

  1.                            GAMESCAPE ver C.1
  2.                     Copyright 1988-92 Dennis Drew. 
  3.                      Copyright strictly enforced.
  4.  
  5.               NOW FEATURING INSTANT ON-LINE REGISTRATION!
  6.  
  7. Documentation file.  Please read this.  Use PGUP/PGDN to move through 
  8. the file.  When finished, press ESC to continue with the GSCAPE program.
  9. To print out this file, press P and then use PGDN to move through the 
  10. entire file.  It will be printed as you scroll.
  11.  
  12.                            REGISTRATION FORM
  13.                         (please print clearly)
  14.  
  15. NAME: __________________________________________________________
  16.  
  17. COMPANY NAME: __________________________________________________
  18.  
  19. ADDRESS: _______________________________________________________
  20.  
  21. CITY: ______________________ STATE: _______ ZIP: _______________
  22.  
  23. PHONE: (_____)_______-_______  PURCHASE DATE: _____/_____/______
  24.  
  25. I acquired this program from:___________________________________
  26.  
  27.               On a scale of 1-10, I rate this program a: 
  28.  
  29.                     1  2  3  4  5  6  7  8  9   10
  30.  
  31.  
  32.  
  33. I acknowledge that I have read and agree to the licensing agreement. I 
  34. request to have my name added to your mailing list for future updates 
  35. and information.  
  36.  
  37.  
  38. ___________________________________________ ___________________
  39. signed                                      date
  40.  
  41.             Please send:  ___ 5.25" disks    ___ 3.5" disks
  42.  
  43.        enclose your check for $95 (we pay shipping) and mail to:
  44.               Dennis Drew  PO Box 101   Joplin, MO  64802
  45.                        VISA/MASTERCARD accepted
  46.  
  47. Please pay by international money order or a check drawn on a U.S. 
  48. bank.  Due to difficulty in processing, no foreign checks, please. 
  49.  
  50.                          ALL USERS!!! IMPORTANT!!!
  51.     The following two lines (with the minimum configurations shown) must 
  52. be in your CONFIG.SYS file on your DOS BOOT disk.  
  53.  
  54.                             FILES=20
  55.                             BUFFERS=20
  56.  
  57.     If you do not have a CONFIG.SYS file on your DOS BOOT disk, or if it 
  58. does not contain at least the above specs, then you must update your 
  59. CONFIG.SYS file so that it does.   To do this, switch to your main 
  60. boot drive (usually either A: or C:) and then enter the following 
  61. lines EXACTLY:
  62.  
  63.     COPY CONFIG.SYS + CON CONFIG.SYS (press enter)
  64.     FILES=20 (press enter)
  65.     BUFFERS=20 (press enter)
  66.     (press F6 key)
  67.     (press ENTER)
  68.     (reboot your computer)
  69.  
  70.     If you are unsure about how to do this, contact your computer dealer.  
  71. This computer file is a STANDARD requirement of most modern computer 
  72. programs and should be present on every computer system.   
  73.  
  74.                           WHAT IS GAMESCAPE?
  75.     GAMESCAPE is the fantastic program that allows you to design and 
  76. distribute your own adventure games.  GAMESCAPE is a powerful 
  77. "adventure engine" that allows you to describe locations and rooms, 
  78. objects, recognizable words, messages, and occurrences that happen 
  79. within the game.  You can also include sound, music, and any of the 
  80. standard IBM special graphics characters (terrific for mapping).   
  81. Registered users can create high-resolution color graphics to go with 
  82. their games! 
  83.     Gamescape encodes information so your game secrets cannot be 
  84. easily deciphered by end users, and allows games to be "linked" so 
  85. that your adventures can be of any length.  It provides you the 
  86. ability to design incredibly detailed and LARGE adventure games with 
  87. far greater ease than using a raw programming langauge.   Once the 
  88. game is finished, registered users are allowed to distribute the games 
  89. with NO ROYALTY FEE-- the initial registration is all that's required.  
  90.  
  91.  
  92.      IMPORTANT NOTICE ON NON-REGISTERED GAME DISTRIBUTION LICENSE:
  93.     You may distribute your GAMESCAPE adventures without being a 
  94. registered user, under the following license requirements: 
  95.     1. You may not charge for your game in any form, not even a 
  96. diskette duplication fee.  It is illegal to commercially distribute a 
  97. game without express, written permission from the author.  What this 
  98. means in short is that you may give copies to your friends, send them 
  99. to penpals, and enter them in GAMESCAPE contests, but you may not 
  100. market them in any fashion, regardless of profit or non-profit motive, 
  101. without express written permission from the author.  You may not 
  102. distribute your game through shareware channels or across BBSs.
  103.     2. You may not use advanced GAMESCAPE features.  Advanced features 
  104. are those found in the REGISTERED version, and include:
  105.     LINKing modules     
  106.     Hires GRAPHICS (although you may use block graphics as is standard
  107.     with the shareware version)
  108.     3. You may not present the game as registered.  You may not use a 
  109. registered version of GAMESCAPE to produce your game (you must use the 
  110. shareware version).
  111.     4. The SCAPERUN.EXE program must be included (of course, or the 
  112. game won't work). 
  113.     Non-compliance with any of these requirements will, by terms of 
  114. our license, void your ownership of your work (in other words, games 
  115. distributed against our license requirements become our property).  
  116. This is not so much for our benefit as it is to protect those who DO 
  117. pay for registration; they deserve the rewards of their payment.
  118.  
  119.                    SPECIAL REGISTERED USER NOTICE!!!
  120.     The REGISTERED version of Gamescape now contains HI-RES GRAPHICS 
  121. ABILITY!!!  Yes, you can create your own B&W or color pictures and add 
  122. them to your games.  This feature is available on the registered 
  123. version only as our way of saying "Thank you for registering!" 
  124.     If you're a registered user, CONGRATULATIONS!  You can just about 
  125. do what you want.  That's what you paid for.  You can use our advanced 
  126. functions including high-res graphics.  You can charge bucks for your 
  127. work.  You can distribute through shareware.  You don't have to pay 
  128. royalties of any kind.  You can give your games away or sell them, and 
  129. pursue any marketing method you wish.  You are fully licensed.  About 
  130. the only thing we require is standard, forseeable stuff, such as:
  131.     1. You must include the SCAPERUN.EXE program when you distribute 
  132. your game (naturally; it's the run-time module).
  133.     2. You may not alter or misrepresent the GAMESCAPE system in any 
  134. manner, or present your games in a manner contrary or harmful to our 
  135. concepts and purposes of GAMESCAPE.  That's all; pretty simple stuff. 
  136.  
  137.     The bottom line:  if you're an unregistered user, feel free to 
  138. give your games to friends and to enter GAMESCAPE contests.  Enjoy 
  139. yourself; we want you to have fun using this excellent program.  But 
  140. remember that there's a lot more available to you if you register! 
  141.  
  142.  
  143.                    INSTRUCTIONS FOR USING GAMESCAPE
  144.     Gamescape is an adventure game development system.  As such it is 
  145. a "programming environment" that provides great power and time-saving 
  146. methods of producing adventure games.
  147.     To see how Gamescape works, enter the following command after 
  148. installation:      GSCAPE SAMPLE
  149.  
  150.     This is the game compiler that will turn the SAMPLE.ADV file into 
  151. an adventure game.  Once the game is compiled, you may then play it by 
  152. exiting Gamescape and entering the command:     SCAPERUN SAMPLE
  153.  
  154.     This will allow you to play the sample adventure game.
  155.  
  156.     Included with this program is GSEDIT.EXE, the powerful Gamescape 
  157. editor.  By examining the TEST.ADV, EASY.ADV and SAMPLE.ADV files you 
  158. may get an idea of how the Gamescape development system works.
  159.  
  160.                        DEVELOPING YOUR OWN GAMES
  161.     The registered version of Gamescape comes with a fully detailed 
  162. instruction manual that lists all of the Gamescape commands and their 
  163. functions.  It also gives you a lot of information about special 
  164. functions of Gamescape not available in the shareware version.
  165.     At this time however, you may begin developing simple adventure 
  166. games by means of the Gamescape Editor, a brand new part of Gamescape 
  167. that helps you in writing correct Gamescape code.  To begin using the 
  168. editor, enter the command:     GSEDIT
  169.  
  170.     We've included a very simple adventure game called EASY that is 
  171. already configured with GSEDIT.  Feel free to examine this file and 
  172. the way it is set up by entering:  GSEDIT EASY
  173.  
  174.  
  175.                           DEVELOPING GRAPHICS
  176.     The graphics development system (GSGRAPH) is available to 
  177. registered users.  Once you register, you will be able to incorporate 
  178. high-resolution graphics in your adventure games.  Gamescape is the 
  179. most advanced and most powerful game development system in the world.  
  180. Registration brings you not only a full instruction manual and 
  181. advanced capabilities, it also allows you to distribute your developed 
  182. adventure games without royalty fee.   Please register today! 
  183.  
  184. ======================================================================
  185.  
  186.                             GAMESCAPE  (TM)
  187.  
  188.  
  189.  
  190.             The incredible program that allows you 
  191.             to design and distribute your own 
  192.             adventure games ! 
  193.  
  194.  
  195.                    Now with Hi-Res Color Graphics ! 
  196.  
  197.  
  198. This shortened manual is designed to give you an idea of the 
  199. possibilities of GameScape.  The full manual along with extended 
  200. program commands is included with the registered version. 
  201.  
  202.  
  203.  
  204. Copyright 1991 Dennis Drew.  Copyright strictly enforced. Gamescape TM 
  205. by Dennis Drew.  All rights reserved.  This manual is copyrighted.  
  206. Copying of this manual is expressly forbidden and punishable under 
  207. Federal and Civil law.  Feel free to copy and circulate the SHAREWARE 
  208. version of this program, but NOT THE MANUAL or the REGISTERED DISK ! 
  209.  
  210.                        Produced by Drew Software 
  211.                     PO Box 101   Joplin, MO  64802  
  212.                              (417)781-4248 
  213.  
  214.                                Gamescape
  215.  
  216.     Imagine writing your own adventure games!  Have your family play 
  217. them, give them to your friends, hand them out at computer clubs, or 
  218. even sell them and make a few bucks! 
  219.     Gamescape is the incredible adventure game design system that lets 
  220. you do all this.  Using simple commands which are thoroughly explained 
  221. by an easy-to-understand manual, you can do just about anything you 
  222. would want to do in adventure gaming: 
  223.     * Define rooms, objects, monsters, and actions 
  224.     * Draw maps using IBM character graphics 
  225.     * Play music, sound alarms, beep warnings 
  226.     * NEW !  High resolution color graphics ability !  
  227.  
  228.     Gamescape also allows you to do things that no other adventure 
  229. system allows.  Your games can be of unlimited size and cover multiple 
  230. disks!  Full random features allow you to perform different actions, 
  231. depending on a "throw of the die".  Rather than hundreds of pages of 
  232. instructions and loads of complex commands, Gamescape has a short, 
  233. consise, uncomplicated manual and just a few short but very powerful 
  234. and versatile commands.  There is virtually no limitation to the 
  235. things you can do with Gamescape! 
  236.  
  237.     Purchasing this package and registering as an official user gives 
  238. you the right to distribute your adventure games without paying any 
  239. kind of a royalty fee.  
  240.     So join the world of adventure gaming today.  Gamescape is raw, 
  241. unbridled power, in an easy-to-use package. 
  242.  
  243.                        Produced by Drew Software   
  244.               PO Box 101  Joplin MO  64802  (417)781-4248 
  245.  
  246. Color hires graphics require an EGA/VGA compatible video system.  CGA 
  247. hires graphics will be in monocolor. 
  248.  
  249.  
  250.     Welcome to Gamescape, the program that lets you write your own 
  251. adventure games AND distribute them for fun or profit! 
  252.  
  253.  
  254.                             GAMESCAPE FILES 
  255.     Once the GS system is "unarced", the following files are present: 
  256.  
  257. GSCAPE.EXE        Main GS "compiler", turns your adventure into 
  258.                   machine readable code.    
  259. GSEDIT.EXE        The new GS editor, guides you through editing your
  260.                   games-- helps prevent grammar errors.
  261. GSGRAPH.EXE       High resolution graphics development program.  
  262.                   Requires CGA/EGA/VGA.  (registered version only) 
  263. SCAPERUN.EXE      "Run-time module", must be distributed with your 
  264.                   compiled adventure code in order for the code to 
  265.                   work.  There is no royalty charge for this module. 
  266. MOUSECUR.COM      Nice mouse driver to use with GSGRAPH. (Reg only)
  267. PALETTE.DAT       Standard palette color file (alterable to suit your 
  268.                   taste in colors) 
  269. TABCONVT.EXE      Converts tabs to spaces in your adventure files. 
  270. FIXWS.COM         Converts WordStar and other non-ASCII files to 
  271.                   straight ASCII. 
  272. EASY.ADV          An easy to understand, simple adventure game example. 
  273. EASY.*            Support files to be used with GSEDIT.EXE
  274. TEST.ADV          A sample adventure game that tests most GS functions. 
  275. STARTER.FIL       Startup file that should be used as a basic model for 
  276.                   all of your adventure games. 
  277. SAMPLE.ADV        Small, fully-developed sample adventure game. 
  278. SAMPLE.IN?        "Include" files for SAMPLE.ADV. 
  279. 1.GR0 thru 5.GR6  Graphics files for SAMPLE.ADV 
  280.         
  281.     If these files are not present, please contact us immediately with 
  282. the name and phone/address of the distributor who supplied the game to 
  283. you, and we'll make them rue their existence on earth (as well as 
  284. correct the situation). 
  285.  
  286.                           WHAT IS GAMESCAPE? 
  287.     Gamescape is an adventure engine.  This means that it makes your 
  288. adventure go, by providing the "fuel". 
  289.     An adventure engine allows you to write an adventure game, and 
  290. then execute it by feeding it into a distributable "run-time" program 
  291. that proceeds to make the game work.  This allows the game to be 
  292. distributed.  Gamescape has no memory limitation, for it pulls its 
  293. information from disk.  While the disk access takes a tiny bit longer 
  294. than a totally memory resident system, it does allow you to write 
  295. adventure games limited only by the size of your imagination 
  296. (Gamescape allows linking of multiple disks and/or multiple game 
  297. modules on a hard disk).
  298.  
  299.                       GAMESCAPE AND YOUR COMPUTER 
  300.     As with any development system, the faster your computer, the 
  301. better.  Gamescape is powerful.  It allows you to develop games of 
  302. almost unlimited size and versatility.  This of course takes 
  303. microprocessor, RAM and disk access time.  While Gamescape works 
  304. properly on a "PC/XT" type machine (8088 microprocessor), it works 
  305. much better on faster computers. 
  306.     8088 systems will work, but will be somewhat slow, especially 
  307. those that are floppy-based.  This is not a fault of Gamescape, but of 
  308. the slow disk and memory access times of those machines.  Of course, 
  309. using Gamescape is still much faster than trying to write an adventure 
  310. game with a standard language compiler.  Then too, there is the 
  311. benefit that your games are no longer limited in size; you can design 
  312. adventure games limited only by the size of your disk.  Gamescape 
  313. really smokes on a 12mhz 286 with a 28ms hard disk drive; that's the 
  314. minimal type of system we recommend for best results from your game 
  315. development environment.  
  316.     But even 8088 disk users will derive value from Gamescape.  Just 
  317. remember that if you have a slow computer, access will be slow.  Be 
  318. patient.  Realize that the first MS-DOS 8088 based computers were 
  319. produced over 10 years ago.  While they're by no means dinosaurs, the 
  320. industry has come a long way since then.  If you plan to write and 
  321. distribute adventure games, you might want to move up to a faster 
  322. machine. 
  323.  
  324.        THE GAMESCAPE INTERFACE -- or how to make the thing work 
  325.  
  326.  
  327.     NORMAL USE.  To use Gamescape, you should start out with the 
  328. GSEDIT program and examine the EASY module.  Check it out and study 
  329. how the logic works.  Then when you have developed your basic skills, 
  330. you can move up to the more advanced functions using the registered 
  331. version of Gamescape and a text editor.
  332.  
  333.     Once you've written the actual adventure, you use the GSCAPE.EXE 
  334. program to compile it.  Compilation turns your adventure into a form 
  335. that Gamescape can read later when the game is actually played. If no 
  336. extension is present, Gamescape automatically adds the .ADV extension. 
  337. So to get the system to compile, you enter the command: GSCAPE 
  338. filename  (you supply the filename) 
  339.     The compiling function creates six new files with the same name as 
  340. your original database, but with the extensions of .GS1 through .GS6.  
  341.     Then you execute the finished game by typing in: SCAPERUN filename 
  342.     Everything is automatic from there on.  Don't expect your 
  343. adventure to work 100% correct the first time; as with any other 
  344. computer project, you'll make mistakes.  But I've put a couple of 
  345. things in the programs to help you locate those errors, so you should 
  346. do OK.  
  347.     Of course, when you distribute your adventure, you have to include 
  348. the SCAPERUN.EXE program with it, because that's what makes the thing 
  349. work.  No problem there; Gamescape was designed with that in mind.  
  350. Just read the licensing agreement and you're all set.  Remember that 
  351. registered users do have extra goodies that they can add to their 
  352. games.  You will find that I'm very friendly with registered users.  
  353. I'll answer questions.  I'll answer letters.  Invite me to a party, 
  354. and I'll probably show up (you pay the travel expenses, o' course!).  
  355.  
  356.                        TRY OUT THE SAMPLE GAME! 
  357.     I've included three sample adventure games called EASY.ADV, 
  358. SAMPLE.ADV, and TEST.ADV.  Try the EASY adventure first.  Then try 
  359. SAMPLE and finally TEST.  SAMPLE contains graphics, and demonstrates 
  360. how graphics appear in the Gamescape environment. 
  361.     This will give you a feel for how Gamescape works, and will show 
  362. you how an adventure data file interfaces with the Gamescape program.  
  363. Go ahead and do this now before reading any further.  SAMPLE is a 
  364. relatively easy adventure game.  It may take you several tries before 
  365. you conquer it, but it only has 5 rooms and will take from 15 minutes 
  366. to an hour to play, depending on your gaming experience.  Once you've 
  367. played it, and read this manual, examine the files thoroughly to see 
  368. how Gamescape works. 
  369.  
  370.                     HOW TO WRITE AN ADVENTURE GAME 
  371.     There are 8 basic steps involved in writing an adventure game.  
  372. These are my concept and you can choose to follow them, alter them for 
  373. your own use, or ignore them as you wish.  But I've found they work 
  374. for me and I feel that if you skip (or skimp on) any one of them, it 
  375. will detract from your game. 
  376.  
  377.     STEP 1.  Start with a theme, a plot that tells what your game is 
  378. going to do.  For example, with my popular game MAROONED AGAIN the 
  379. theme was: 
  380.  
  381.     You have crash-landed on an alien planet.  But all is not lost; 
  382. you have found an alien ship.  The crew apparently died from some 
  383. strange disease.  The ship is still in good condition, but it was not 
  384. built for human anatomy to withstand a blast-off. 
  385.     Fortunately, you have super-strong clones aboard your ship, but 
  386. they were damaged in the crash.  They now only recognize 1 or 2 words 
  387. at a time.  Your goal:  send them aboard the alien ship, find the 
  388. components required to get it to blast off, and send them for help. 
  389.  
  390.     See how that works?  You need a theme of your own, something to 
  391. tie the entire game together. 
  392.  
  393.     STEP 2.  Once the theme is established, start writing down 
  394. individual things you'd like to have happen in the game.  For example, 
  395. you may find a key that's required to open a door located elsewhere.  
  396. Or you may have to fight a robot to gain access to a room.  Don't get 
  397. too complex.  Take my word for it; adventure games get complex all on 
  398. their own as you start writing the actual code.  
  399.  
  400.     STEP 3.  Draw a map.  Set up rooms and corridors, or open land 
  401. areas, etc., keeping in mind the things in step 2 so you can 
  402. incorporate them into your map.  Use a big sheet of paper and make the 
  403. rooms large (2" square is a good size) because you're going to be 
  404. scribbling in details later.  The key to proper adventure game writing 
  405. is advanced planning.  You should have the entire game designed before 
  406. you begin writing one line of code! 
  407.  
  408.     STEP 4.  Number the rooms.  Room #1 is always the starting 
  409. location of the adventure. 
  410.  
  411.     STEP 5.  Go through the rooms one by one and make a list of the 
  412. OBJECTS in the rooms, and the WORDS that will be required to play the 
  413. adventure.  This will only be a partial list; as you test the 
  414. adventure you'll probably find more objects and words that you'll 
  415. need.  Try to be as thorough as possible. 
  416.  
  417.     STEP 6.  Make sure the game is logical.  One of the worst problems 
  418. with many adventure games is that the things the author requires you 
  419. to do don't make any sense.  I remember one game I played where I 
  420. found an Egyptian statue that would kill me every time I got near it.  
  421. I could find no way around this.  When I started asking around and 
  422. tore the game apart, I finally discovered that a ruby found earlier in 
  423. the game (which the game stated was a treasure) was actually the heart 
  424. of the statue, and had to be thrown into a lava pit.  There were no 
  425. clues that this should be done, no hints.  Totally illogical.  I hate 
  426. an adventure game that requires the player to be stupid and do 
  427. ignorant and dumb things in order to make the game work (there is a 
  428. difference of course, between stupid things and sneaky things).  So 
  429. ask yourself as you write the game: If I were playing the game, would 
  430. this be a logical thing to do, something that I might actually think 
  431. of doing?  If the answer is "no", eliminate that thing and do it some 
  432. other way. 
  433.  
  434.  
  435.     STEP 7.  Once you're convinced the game is logical, begin writing 
  436. the code.  There is a file called STARTER.FIL that should be the heart 
  437. of every adventure you write.  It includes standard adventure 
  438. functions, as well as a few required adventure functions that you'll 
  439. need for each game.  You can alter it any way you wish; it's just a 
  440. guideline to use.  
  441.     Of course, do not alter  STARTER.FIL itself; copy it to another 
  442. file:     COPY STARTER.FIL MYGAME.ADV 
  443.     Then use the MYGAME.ADV file to write your adventure. 
  444.  
  445.     STEP 8.  Writing the game and testing it yourself is called the 
  446. alpha stage.  Beta test stage is the important one.  Call in a friend 
  447. who enjoys playing adventure games (not two, because you'll want to 
  448. beta test this on several individuals) and let him have at it.  Grab a 
  449. pencil and notebook and sit by him the whole time.  Don't give any 
  450. hints; figuring out the adventure is part of the testing.  Give hints 
  451. and you'll ruin the spontenaity such testing requires.  Resign 
  452. yourself to the fact that you will most likely need several sessions 
  453. to test a game propery.  This is the research & development stage; R&D 
  454. takes time.  Anything worth doing... 
  455.     As you note errors in the game (and you will) write down the 
  456. circumstances and errors that result.  Take legible, detailed notes.  
  457. But don't alter the game right then unless it is unplayable due to 
  458. that error.  Let your friend finish playing, all the while writing 
  459. down alterations.  Also, make notes of things you wish to add to the 
  460. game; you'll find lots of things to include that you didn't think of 
  461. before.  
  462.     Once your friend has finished playing (this may take many, many 
  463. hours, or even several sessions, depending on the complexity of the 
  464. game) then make the changes to your game, and call over another 
  465. friend.  Go through the same process again.  Do this two, three, four, 
  466. or five times if necessary, until the game is playable.  Don't try to 
  467. cover every possible situation that might occur; just make sure that 
  468. the things you do allow in your game, work properly.  
  469.     After this is done, you are now to gamma production stage, which 
  470. means that your game is ready to distribute. You may still find minor 
  471. bugs in your code as the months go by, but none of them should 
  472. seriously affect game play and for the most part everything will be 
  473. fine.  
  474.  
  475.  
  476.                     VERY IMPORTANT!  DEBUGGING CODE 
  477.     Gamescape is a very complex project, and I would be foolish to 
  478. imagine that some obscure bug doesn't exist somewhere.  If you find a 
  479. legitimate bug, I will appreciate you letting me know.  However, 
  480. please do so under the following guidelines: 
  481.  
  482.     #1 AND MOST IMPORTANT:  Remember that Gamescape is a programming 
  483. environment, and it has been used to generate very complex adventure 
  484. games.  It is therefore reasonable to assume that most (if not all) of 
  485. the bugs have been discovered.  Whenever you find what you think is a 
  486. bug, realize that it is most likely in your game code, and not a 
  487. problem with Gamescape.  
  488.     Before you report a bug, go over your code with a fine tooth comb.  
  489. Whether or not we charge you for examining your code depends on 
  490. whether the bug is caused by Gamescape, or by user coding errors. If 
  491. we have to spend time hunting for a bug that we find to be user 
  492. programming code errors, we will have to bill the user for that time.  
  493. This may seem unfair, but A) we will help the user discover the 
  494. mistake and thus have rendered a programming service and B) we deserve 
  495. to be reimbursed for time/wage/computer expense involved in finding 
  496. user coding errors.  Even in such a case, our rates are reasonable, 
  497. and can be avoided completely if you make sure that a bug report is an 
  498. actual bug.  
  499.     Note that billing will only be done if we feel that significant 
  500. time was wasted.  We're not going to worry about minor work... that's 
  501. just part of doing business and supporting you as a registered user of 
  502. Gamescape.  
  503.     #2:  An error message does not mean a Gamescape bug.  It likely is 
  504. pointing out a problem with your code.  Check out the error; you may 
  505. find it means something like "printer not on" or "disk full" or 
  506. something like that.  Or, it may mean you've left out a part of an 
  507. IF/DO line which causes Gamescape to return an error such as "Out of 
  508. string space" or "Bad record number" or "Illegal function call" (that 
  509. happens more than adventure programmers like to admit). Such things 
  510. are programmer errors, and are not likely to be a fault of Gamescape.  
  511.     #3:  If you do find what you feel to be a legitimate bug, write us 
  512. a letter fully documenting the info.  A phone call is allowed as well, 
  513. but the phone is mainly for answering questions, not in trying to 
  514. trace down a supposed bug.  If you can send us a disk with your source 
  515. code, that will be appreciated as well (source codes will be kept 
  516. extremely private and secured... we will not release or distribute 
  517. them under any circumstance.  They will be used solely for the purpose 
  518. of documenting the bug). 
  519.     #4:  We will not consider any bug report from an unregistered 
  520. user.  No exceptions.  If you claim you have found a bug and we find 
  521. you are not registered, we will totally ignore you. Sorry, but that's 
  522. what registration means: support.  If you are unregistered then you 
  523. are not aware of updates, changes, techniques, etc.  We will not waste 
  524. time with an unregistered user, no matter how legitimate you think 
  525. your problem may be. Bottom line:  if you want the support, then 
  526. please register. 
  527.     #5:  If you do find a legitimate bug, we will send you one of our 
  528. nifty adventures free of charge, as well as give you credit for the 
  529. bug find in future documentation! 
  530.  
  531.     Thanks for your attention to these matters. 
  532.  
  533.  
  534.                          GAMESCAPE ERROR CODES
  535.     Gamescape is written using Microsoft QuickBASIC 3.0 and uses most 
  536. standard BASIC error codes.  I am listing them here for your 
  537. convenience in tracking down your game code errors.  Please note that 
  538. an error that pops up does not likely mean Gamescape has a bug; if you 
  539. have not yet read the section on debugging code, do so now.  It is 
  540. extremely important.  
  541.  
  542. 1   NEXT WITHOUT FOR            
  543. 2   SYNTAX 
  544. 3   RETURN WITHOUT GOSUB    
  545. 4   OUT OF DATA 
  546. 5   ILLEGAL FUNCTION CALL    
  547. 6   OVERFLOW 
  548. 7   OUT OF MEMORY                
  549. 8   UNDEFINED LINE NUMBER 
  550. 9   SUBSCRIPT OUT OF RANGE      
  551. 10  DUPLICATE DEFINITION 
  552. 11  DIVISION BY ZERO                
  553. 12  ILLEGAL DIRECT 
  554. 13  TYPE MISMATCH                
  555. 14  OUT OF STRING SPACE 
  556. 15  STRING TOO LONG                
  557. 16  STRING FORMULA TOO COMPLEX         
  558. 17  CAN'T CONTINUE                
  559. 18  UNDEFINED USER FUNCTION 
  560. 19  NO RESUME                              
  561. 20  RESUME WITHOUT ERROR 
  562. 22  MISSING OPERAND                
  563. 23  LINE BUFFER OVERFLOW 
  564. 24  DEVICE TIMEOUT                
  565. 25  DEVICE FAULT 
  566. 26  FOR WITHOUT NEXT              
  567. 27  OUT OF PAPER  
  568. 29  WHILE WITHOUT WEND        
  569. 30  WEND WITHOUT WHILE 
  570. 50  FIELD OVERFLOW                
  571. 51  INTERNAL ERROR 
  572. 52  BAD FILE NUMBER                
  573. 53  FILE NOT FOUND 
  574. 54  BAD FILE MODE                    
  575. 55  FILE ALREADY OPEN 
  576. 57  DEVICE I/O ERROR                
  577. 58  FILE ALREADY EXISTS 
  578. 61  DISK FULL                        
  579. 62  INPUT PAST END                    
  580. 63  BAD RECORD NUMBER        
  581. 64  BAD FILE NAME                        
  582. 66  DIRECT STATEMENT IN FILE 
  583. 67  TOO MANY FILES 
  584. 68  DEVICE UNAVAILABLE        
  585. 69  COMMUNICATION BUFFER OVERFLOW 
  586. 70  DISK WRITE PROTECT         
  587. 71  DISK NOT READY 
  588. 72  DISK MEDIA ERROR            
  589. 73  ADVANCED FEATURE 
  590. 74  RENAME ACROSS DISKS         
  591. 75  PATH/FILE ACCESS ERROR     
  592. 76  PATH NOT FOUND 
  593.          (you probably didn't install CONFIG.SYS properly) 
  594.  
  595.  
  596.     Please register for Gamescape.  Not only does registration provide 
  597. you with expanded abilities and privileges,  registrations encourage 
  598. us to update the program and add even more power, so that your games 
  599. can be more impressive than ever before.  The more registrations we 
  600. receive, the more eager we are to provide regular updates to the 
  601. program.  Thank you for registering ! 
  602.  
  603.  
  604.     The remainder of this manual is contained in the registered 
  605. version.  To get started writing your own adventure games, please use 
  606. the GSEDIT program.  Realize however, that the registered manual 
  607. provides you with a great deal of information that is required for 
  608. professional game development.  
  609.  
  610.                    THANK YOU FOR EXAMINING GAMESCAPE
  611.  
  612.  
  613.                             end of manual 
  614.  
  615.                 Gamescape is written and published by: 
  616.  
  617.       Drew Software    PO Box 101   Joplin, MO  64802   (417)781-4248 
  618.  
  619. ======================================================================
  620.                       Please read the following: 
  621.     
  622.            IMPORTANT:   HOW TO OBTAIN THE INSTRUCTION MANUAL 
  623.     Our programs are very easy to use.  You do not need an instruction 
  624. manual to operate them.  However, the manual allows you to gain 
  625. greater benefit from this program.  To get the manual, you must 
  626. REGISTER with us.  We depend on your registration fee to continue 
  627. operation.  Registration brings you: 
  628.     1. Instruction manual.
  629.     2. Call-in telephone support.
  630.     3. Places you on our mailing list for notification of future 
  631. updates.  
  632.     4. Usually brings you a more advanced version of the program.
  633.  
  634.     We will support you if you register; absolutely no support will be 
  635. given to non-registered users.  
  636.                                 
  637.                 USER REGISTRATION AND LICENSE AGREEMENT
  638.  
  639. ARTICLE 1. ACCEPTANCE.
  640.     In registering for our programs, the user agrees to abide by all 
  641. articles and restrictions of this license. It is the responsibility of 
  642. the purchaser to note the items of this license, and decide upon 
  643. agreeability of its terms prior to the registration of the program.  
  644.  
  645. ARTICLE 2. LICENSING.  
  646.     This program is licensed, not sold. As such, the user/ 
  647. purchaser has the right to use the program on a day-to-day basis, 
  648. but recognizes the ownership of the program and all materials as 
  649. belonging to Dennis Drew.
  650.  
  651. ARTICLE 3. COPYING AND MULTI-USER.
  652.     This program is USER SUPPORTED.  You are encouraged to copy 
  653. the SHAREWARE diskette and give it to your friends and acquaintences.  
  654. You may use this program freely and distribute it as you wish.  
  655. However, the following restrictions do apply: 
  656.     1. You may not charge a fee for this program, other than for 
  657. the cost of duplication.  
  658.     2. You may not alter the program or supporting items in any 
  659. manner, may not add to or remove items from the disk.  
  660.     3. You may not copy or reproduce in any way the instruction manual 
  661. that is available for this program. The instruction manual is provided 
  662. to REGISTERED USERS ONLY.  Copying of this manual in any form is 
  663. strictly forbidden.  If several copies of the manual are required, 
  664. then a discount is provided on request.  
  665.     4. Shareware companies must obtain a distribution license from the 
  666. author.
  667.  
  668. ARTICLE 4. WARRANTY AND LIABILITY.
  669.      It is the responsibility of the purchaser to decide upon 
  670. usability and application of this program to his/her particular 
  671. needs. Every effort has been made to insure the accuracy and 
  672. reliability of this program. However, since the success of this 
  673. program relies a great deal upon individual use and dedication to 
  674. the use thereof, and the fact that this program is user copiable 
  675. (thus limiting our control over what the end-user receives), 
  676. We will not be held responsible for any results obtained from the 
  677. direct or indirect use of this program nor does this program 
  678. comply to the laws of merchantability of any state.  
  679.  
  680. ARTICLE 5. TERMINATION.
  681.      If the user/purchaser breaks any article of this agreement, 
  682. all items pertaining to the program shall be returned to the 
  683. publisher. This will not exclude any additional punitive damages 
  684. incurred according to national and civil laws.  
  685.  
  686. ARTICLE 6. CUSTOMER SUPPORT.
  687.      We are eager to support our customers. Technical 
  688. assistance is available to REGISTERED USERS ONLY by calling 
  689. (417)781-4248 Monday through Friday during the hours of 9am to 
  690. 5pm.  
  691.      If your diskette is damaged in any way, return it to us along 
  692. with $10.00 to cover cost of replacement. We will rush you a new 
  693. diskette.  
  694.      It is recognized that the purchaser is already bound by the terms 
  695. of the LICENSING AGREEMENT enclosed with this package. This 
  696. registration form serves two purposes: 
  697.      1. To emphasize agreement with the terms of the license.
  698.      2. To allow us to provide you with timely updates and information.  
  699.      
  700.  
  701.                     Thank you for registering!
  702.  
  703.  
  704.